home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / sound / tumodu36.zip / MODUTILS.DOC < prev   
Text File  |  1993-11-28  |  27KB  |  608 lines
  1. ▀▀█▀▀ ▄▀▀▄ ▀▀█▀▀ ▄▀▀▄ █   █  █ █    █  █ █▄  █ █   █ █▄ ▄█ █ ▀▀█▀▀ █▀▀ █▀▀▄
  2.   █   █  █   █   █▀▀█ █   █   █     █  █ █ ▀▄█ █   █ █ ▀ █ █   █   █▀  █  █
  3.   ▀    ▀▀    ▀   ▀  ▀ ▀▀▀ ▀▀▀ ▀      ▀▀  ▀   ▀ ▀▀▀ ▀ ▀   ▀ ▀   ▀   ▀▀▀ ▀▀▀
  4.   ███▄ ▄███  ▄██████▄ ████████▄ ███   ███ ████████▀ ███ ███      ▄███████
  5.   ███▀█▀███ ▐██   ███ ███   ███ ███   ███ ▀  ███    ███ ███     ███
  6.   ▐██ ▐ ▐██ ▐██   ▐██ ▐██   ▐██ ▐██   ▐██    ▐██    ▐██ ▐██     ▐██
  7.    ██    ██  ██    ██  ██    ██  ██    ██     ██     ██  ██      ▀█████▄
  8.    ▐█    ▐█  ▐█    ▐█  ▐█    ▐█  ▐█    ▐█     ▐█     ▐█  ▐█            ▐▌
  9.     █     █   █     █   █     █   █     █      █      █   █             █
  10.     ▐     ▐    ▀▀▀▄▄▀   ▐▄▄▄▄▄▀   ▐▄▄▄▄▄▀      ▐      ▐   ▐▄▄▄▄▄▄ ▄▄▄▄▄▄▀
  11.  
  12.   ░░▒▒▓▓████████     T O T A L L Y   U N L I M I T E D     ░░▒▒▓▓████████
  13.  
  14.   ▓▓████  ██████     *   M O D U T I L S   v 3 . 6   *     ▓▓████  ██████
  15.       ██  ██                                                   ██  ██
  16.   ██  ██  ██  ██              (c) 1993.11.28               ██  ██  ██  ██
  17.   ██  ██  ██  ██                                           ██  ██  ██  ██
  18.   ██  ██████  ▓▓   by Tom Rathborne of Totally Unlimited   ██  ██████  ▓▓
  19.   ██          ▒▒                                           ██          ▒▒
  20.   ████████▓▓▒▒░░         The MODUTILS are FREEWARE!        ████████▓▓▒▒░░
  21.          ^                                                       ^
  22.          │    (but if you like it, you can still send money!)    │
  23.          │                                                       │
  24.          └────── My neat logo encompassing the T and the U ──────┘
  25.  
  26.   ┌──────────╖
  27. ──┤ CONTENTS ╟─────────────────────────────────────────────────────────────
  28.   ╘══════════╝
  29.  
  30.         ABOUT MODUTILS
  31.         GENERAL NOTES
  32.  
  33.         MODDIR
  34.         MODNAMES
  35.         MODDIZ
  36.  
  37.         FORMATS SUPPORTED
  38.  
  39.         ABOUT THE AUTHOR
  40.         OTHER STUFF
  41.         THANKS
  42.         FUTURE FEATURES
  43.         HISTORY
  44.  
  45.   ┌────────────────╖
  46. ──┤ ABOUT MODUTILS ╟───────────────────────────────────────────────────────
  47.   ╘════════════════╝
  48.  
  49.     With the advent of Creative Labs' SoundBlaster audio card, the Amiga
  50.     .MOD (Module) format of music is now very popular on the PC-compatible
  51.     scene. There are LOTS of different types out there, too. I add every
  52.     format that I can find, even those that can only be played on the
  53.     Amiga!
  54.  
  55.     The three MODUTILS will list directories describing modules with titles
  56.     and formats:
  57.  
  58.     MODDIR outputs to the screen like a very simple DIR command.
  59.  
  60.     MODNAMES creates a 4DOS/NDOS DESCRIPT.ION file.
  61.  
  62.     MODDIZ creates a FILE_ID.DIZ for SysOps.
  63.  
  64.     Best of all, it's all freeware! That means you can copy these programs
  65.     all you want, as long as you don't modify them, and you include this
  66.     document. Support freeware! Use it! Distribute it! Of course, if you
  67.     have any questions or comments, or if you think the MODUTILS are worth
  68.     a few $, feel free to contact me.
  69.  
  70.   ┌───────────────╖
  71. ──┤ GENERAL NOTES ╟────────────────────────────────────────────────────────
  72.   ╘═══════════════╝
  73.  
  74.     The MODUTILS should work properly with all module file formats listed
  75.     in the FORMATS SUPPORTED section. They originally just read the first
  76.     20 characters of the file, but some formats don't conform to that, so
  77.     the autorecognition routine was born, opening up a whole new bunch of
  78.     formats. If you find a module that the MODUTILS can't identify, please
  79.     let me know, and I'll add support for it as soon as possible!
  80.  
  81.     If the location of the title for the particular format is unknown to
  82.     me, as in FutureComposer and some MED files, the title will be simply
  83.     "Unknown: [filename]". If the title part of the file is empty the title
  84.     will be "File: [filename]".
  85.  
  86.     If the file has the correct signature, but the title includes control
  87.     characters (less than ASCII 27), the title will appear as "[ Might be
  88.     corrupt ]"
  89.  
  90.     You may get an error message if you try to look at another directory.
  91.     For example, if you are in the root directory, and type "MODDIR
  92.     C:\MODS" or "MODDIR C:\MODS\*.*", I haven't added support for that kind
  93.     of thing yet. Sorry.
  94.  
  95.   ┌────────╖
  96. ──┤ MODDIR ╟───────────────────────────────────────────────────────────────
  97.   ╘════════╝
  98.  
  99.     MODDIR defaults to listing ALL identifiable files in the current
  100.     directory. If it finds a file that it cannot identify as a MOD, it will
  101.     not list it.
  102.  
  103.     If you specify a filespec, i.e. *.MOD, then all those files will be
  104.     listed regardless of whether or not they can be identified.
  105.  
  106.     If you don't specify a filespec and no valid modules are found, you'll
  107.     simply see a blank list. If you DO specify a filespec, invalid files
  108.     will be displayed with "[ Unknown Type ]" as the title, and you'll get
  109.     a different set of totals (try it!) at the bottom.
  110.  
  111.     To display a directory, simply change to the directory where you store
  112.     your modules and run MODDIR. Remember, you can't specify another
  113.     directory - only a file specification. Here's some sample output:
  114.  
  115.  ╔════════════════════════════════════════════════╤═══════════════════════════╗
  116.  ║ MODDIR v3.6 ■ (c)1993.11.28 by Tom Rathborne ■ │  MODDIR is FREEWARE from  ║
  117.  ║ Directory of *.*                               │     Totally Unlimited     ║
  118.  ╠══════════════╤══════════╤══════════════════════╪═══════════════════════════╣
  119.  ║ Filename     │ Size     │ Song Title           │ File Type                 ║
  120.  ╟──────────────┼──────────┼──────────────────────┼───────────────────────────╢
  121.  ║ HARDWIRE.669 │    62040 │ Hardwired...         │ Composer 669 Module       ║
  122.  ║ NITEFLYT.AMF │    71566 │ NiteFlite            │ Advanced Module Format    ║
  123.  ║ CYTAX   .FC3 │    11914 │ Unknown:CYTAX.FC3    │ Future Composer [FC14]    ║
  124.  ║ REBELS  .FC3 │     4790 │ Unknown:REBELS.FC3   │ Future Composer [SMOD]    ║
  125.  ║ MENOLLY .FTM │   141786 │ Menolly's Song       │ Face the Music            ║
  126.  ║ AD_NSTLL.INI │     4022 │ [ Might be corrupt ] │ Tracker - 15 instruments  ║
  127.  ║ BLUEBABY.MED │   257426 │ Blue Baby Filters -  │ MED file                  ║
  128.  ║ HUH!    .MED │    54003 │ Unknown:HUH!.MED     │ Some sort of MED file     ║
  129.  ║ ALISON  .MOD │     7934 │ Alisons song         │ FastTracker - 6 channels  ║
  130.  ║ ALISON-S.MOD │     7934 │ Alisons song         │ StarTrekker - 6 channels  ║
  131.  ║ CLEMENTI.MOD │    23608 │ Clementine           │ FastTracker - 8 channels  ║
  132.  ║ DEEELITE.MOD │   255294 │ Deee-lited           │ StarTrekker - 4 channels  ║
  133.  ║ GONAD-64.MOD │     8591 │ Gonads Cracks        │ ProTracker > 64 patterns  ║
  134.  ║ GONADSCR.MOD │     8591 │ Gonads Cracks        │ Tracker - ModEdit         ║
  135.  ║ POPCORN .MOD │    61846 │ Popcorn              │ Tracker - 15 instruments  ║
  136.  ║ RAP-STAR.MOD │    53542 │ Rap Beat             │ StarTrekker - 8 channels  ║
  137.  ║ RAPBEAT .MOD │    53542 │ Rap Beat             │ OctaCompositor 8 channels ║
  138.  ║ REACHTEC.MOD │   139286 │ Reach Tech-No Limit  │ ProTracker                ║
  139.  ║ SOWHAT-K.MOD │    10605 │ So What?             │ Tracker - KingMOD         ║
  140.  ║ HARMNICS.MTM │    77100 │ Digital Harmonics    │ MultiTrackerModule        ║
  141.  ║ ALIENMEN.MUS │    41830 │ ALIENMENU            │ SMUS v.2 Module           ║
  142.  ║ THUNDER .OCT │   247028 │ Thunder              │ OctaMED file              ║
  143.  ║ JAM     .OKT │   289280 │ JAMES BROWN IS DEAD! │ Oktalyzer                 ║
  144.  ║ ROMPLAY2.ROM │   151096 │ Unknown:ROMPLAY2.ROM │ RoM MuZiK FiLe            ║
  145.  ║ PLASTIC .S3M │    64784 │ World of Plastic     │ ScreamTracker 3 Module    ║
  146.  ║ GC-REMIX.STM │    10112 │ Gonads Cracks Remix  │ ScreamTracker Module      ║
  147.  ║ DRUMROLL.STS │     1595 │ A Drum Roll, Please. │ ScreamTracker Song        ║
  148.  ║ ROCKET  .ULT │   195626 │ ROCKET               │ UltraTracker Module       ║
  149.  ╟──────────────┼──────────┴───────────┬──────────┴───────────────────────────╢
  150.  ║   28 modules │  2316771 total bytes │ ■ Thank you for using MODDIR! ■ TU ■ ║
  151.  ╚══════════════╧══════════════════════╧══════════════════════════════════════╝
  152.  
  153.     The most error checking